*********************************************************
DotSTORM V1 Alpha
Developed by: Stephen Brennan
Email: bstephen78@yahoo.com
*********************************************************
Contents:
1 Introduction
2 How to Play
3 Level Developing
4 Special Thanks
5 License
6 Version History

*********************************************************
1 Introduction
*********************************************************
DotSTORM is a puzzle program written in TI-BASIC.
The goal of DotSTORM is to eliminate dots from the screen.
This game is still in its alpha stage of development.  
It does not yet have the High Scores feature and levels
aren't written yet.  However, you can develop your own levels
and play them in this version.

This program is edit protected and accessible through MirageOS.
You are free to unprootect it with MirageOS.  Edit 
protecting is just a precaution to keep you from accidentally
damaging the program.

Also, source code is in the SOURCE.txt file included.  As it
says at the top of the file, it is best to view it with a font
downloaded from Texas Instruments at:
http://education.ti.com/educationportal/sites/US/productDetail/us_key_font_83p_84p.html

Items still to come (list subject to change):
TODO: Add High scores
TODO: Add Built in levels
*********************************************************
2 How to Play
*********************************************************
Menu:

DOTSTORM
1:PLAY GAME
2:LEVEL EDITOR
3:HOW TO PLAY
4:**HIGH SCORES
5:ABOUT
6:EXIT

1: Play Game:
This starts the game.  You are taken to a level menu to select
your level.  

SELECT LEVEL
1:LEVEL 1
2:LEVEL 2
3:LEVEL 3
4:LEVEL 4
5:LEVEL 5
6:LOAD LEVEL (L2

Currently, it doesn't matter what level you choose; it 
will give you a level with two dots.  You can use a level 
that you have developed (option #6) that is stored in the 
L2 slot.
After you have selected a level, you come to the game screen.
Your cursor is at the upper left hand corner.  Move it with
the direction buttons.  Pressing 2nd function here will quit
to the main menu.  Your cursor, when moving onto a space with
no dot will turn the space into a dot.  When it is moving onto
a dot, it will erase the dot.  Erase all of the dots to win.

2: Level Editor
This starts the built-in level editor, which is covered in more
detail in the second section of the Level Developing chapter.

3: How to play
This will bring up a limited help screen.  Hit enter to 
to continue from screen 1 to screen 2 and from screen 2 back
to the main menu.

4: **High scores
High scores are not developed yet.

5: About
Displays an about screen with my my name and the version #
on it.

6: Quit
Exits the game.

*********************************************************
3 Level Developing
*********************************************************
Since there are no built in levels yet, you can make your own.
There are two ways to develop levels in the beta version.
1: Manual

The manual technique is a bit technical, but it does have
certain advantages over the level editor.  As you will soon
learn in the 2: Built-in Level Editor section, the level
editor operates exactly as the game, erasing existing dots
or adding new ones.  This can be tough to work with (if you're
smart enough, you can make it work OK), so use this method
for levels that seem impossible on the editor.

Making levels the manual way:
The game is played on a grid with 20 rows and 31 columns.
It is laid out like this:

		Columns
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17...
   .------------------------------------------
  1 |. . . . . . . . .  .  .  .  .  .  .  .  .
  2 |. . . . . . . . .  .  .  .  .  .  .  .  .
  3 |. . . . . . . . .  .  .  .  .  .  .  .  .
  4 |. . . . . . . . .  .  .  .  .  .  .  .  .
R 5 |. . . . . . . . .  .  .  .  .  .  .  .  .
o 6 |. . . . . . . . .  .  .  .  .  .  .  .  .
w 7 |. . . . . . . . .  .  .  .  .  .  .  .  .
s 8 |. . . . . . . . .  .  .  .  .  .  .  .  .
  9 |. . . . . . . . .  .  .  .  .  .  .  .  .
  10|. . . . . . . . .  .  .  .  .  .  .  .  .
  11|. . . . . . . . .  .  .  .  .  .  .  .  .
  12|. . . . . . . . .  .  .  .  .  .  .  .  .
...

Make a level by listing the points in the list variable L2
like so:
CC: Column (must be two digits (ie. 1 should be 01))
RR: Row

{RR.CC,RR.CC,RR.cC, etc}

You can have as many points as you want, your only limit is
your calc's memory.

Once you have made your level, run DOTSTORM, select Play Game,
and select Load Level (L2.

2: Built-in Level Editor
When you select the second option on the main menu, you are
taken here, to the built-in editor.  This is a compact level
editor where you can make your levels and then save them to 
be played.  It saves you the numbers and confusion of the 
previous method, but has its own limitations.  One limitation
is that you can't open your previous levels and work on them.

To make a level:
Enter the level editor using the second option on the main
menu.  Your cursor is at the upper-left corner of the screen.
Move it around just like you would play the game.  This has its
limits, but it is the best way to combine power and size in
the best interest of your calculator.

Once you have made the level exactly the way you want it, hit
enter.  The editor will tell you that it is saving the level.
It is being saved in the list variable L2.  

You can then play the level you made by selecting the play game
option from the main menu.  Then select the option 6:Load level
(L2).

If you like the level you made, it might be a good idea to 
back it up to a list variable where it will not be edited by 
DotStorm: any list variable other than L1 or L2.  You can do
that like this (on the home screen):
L2 -> L3
When you are ready to play that level again, do the opposite
just before you play the game:
L3 -> L2



*********************************************************
4 Special Thanks
*********************************************************
Special thanks to http://tibasicdev.wikidot.com.  This website 
helped me a whole lot with various things involving BASIC
programming.

Also, this program was debugged with an emulator called 
WabbitEmu.  Developed by Revolution Software, it has been a 
huge help.  Check them out at:
http://www.revsoft.org

Also, I got my calc's ROM image with a program called rom8x.
If you've got an 83/84/+/se and you can't seem to get your rom
image, try it out here:
http://www.ticalc.org/archives/files/fileinfo/373/37341.html

I would like to thank TiCalc.org for hosting my file.

*********************************************************
5 License
*********************************************************
Copyright (C) 2009 Stephen Brennan
This program is distributed under the terms of the GNU
General Public License.

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation, version 3.

Tis program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
the GNU General Public License for more details.

You should have received a copy of the GNU General Public
License along with this program under the filename GPL.txt.
If not, see <http://www.gnu.org/licenses/>.

*********************************************************
6 Version History
*********************************************************
Version 1 alpha [1/21/08]:  first build 
Version 2 beta  [2/1/08]:   includes new on-board level editor
